home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds / ranlib.man < prev    next >
Text File  |  1990-11-12  |  1KB  |  52 lines
  1. '\" Copyright 1990 Regents of the University of California
  2. '\" Permission to use, copy, modify, and distribute this
  3. '\" documentation for any purpose and without fee is hereby
  4. '\" granted, provided that this notice appears in all copies.
  5. '\" The University of California makes no representations about
  6. '\" the suitability of this material for any purpose.  It is
  7. '\" provided "as is" without express or implied warranty.
  8. '\" 
  9. '\" $Header: /sprite/src/cmds/ranlib/RCS/ranlib.man,v 1.1 90/11/12 11:56:43 kupfer Exp $ SPRITE (Berkeley)
  10. '/" 
  11. .so \*(]ltmac.sprite
  12. .HS RANLIB cmds
  13. .BS
  14. '\" Note:  do not modify the .SH NAME line immediately below!
  15. .SH NAME
  16. ranlib \- make symbol table for object library
  17. .SH SYNOPSIS
  18. \fBranlib\fR [\fB\-f\fR] \fIarchive ...\fR
  19. .SH OPTIONS
  20. .IP "\fB\-f\fR" 15
  21. Force the symbol table to be regenerated.
  22. .BE
  23.  
  24. .SH DESCRIPTION
  25. .PP
  26. .B Ranlib
  27. generates a file called __.SYMDEF with a table of external symbols for
  28. an archive.  It puts it in the archive for use by
  29. .BR ld .
  30. .PP
  31. The current version of 
  32. .B ranlib
  33. is actually a wrapper over
  34. .BR ar ,
  35. which maintains the symbol table in-place, as the archive is updated.
  36. Any arguments that the old
  37. .B ranlib
  38. took are ignored by this version.
  39. .PP
  40. If the symbol table already exists, 
  41. .B ranlib
  42. is normally a no-op.  If the symbol table has somehow become
  43. corrupted, use the 
  44. .B \-f
  45. flag to force it to be regenerated from scratch.
  46.  
  47. .SH "SEE ALSO"
  48. ld, ar
  49.  
  50. .SH KEYWORDS
  51. library, archive
  52.